home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / fido / SHELTER275.lha / XPRS / xprfts.doc < prev    next >
Text File  |  1994-12-03  |  5KB  |  130 lines
  1.  
  2.             XPRFTS.LIBRARY
  3.             Robert Williamson
  4.             based upon original documentation by Russell McOrmond
  5.  
  6.     Additions and Fixes:
  7.     
  8.     Dec 3.1994
  9.     Removed L flag setup option, link rate is now obtained via WXI functions.
  10.  
  11.     Previous:
  12.     Sealink flags O and I would cause errors because they were not as
  13.     documented.  The library was looking for Y/N/B, not S/T/B.  The library
  14.     now agrees with the documentation.
  15.  
  16.     Added L flag to pass link rate to library.
  17.  
  18.     Removed D flag.
  19.  
  20.     Added updstatus support. (XPR3)
  21.  
  22.     Added dual-status support (XPR2.001)
  23.  
  24.     Since  this library will not be of much use in a term program, xpr user
  25. setup interface was not added.
  26.  
  27.     Fixed turnaorund and xpr_fnext problems.
  28.  
  29.     Changes:
  30.         Removed copyright by Russell McOrmond from crc.c.
  31.         Removed unused crc32 table,macros and functions from crc.
  32.  
  33.     DO  NOT  use  this or any earlier version of xprfts.library for SeaLink
  34. under EMSI.  Since xprfts performs FTS1 negotiation, using it under EMSI is
  35. a  violation  of  technical standards.  Please use xprslk.library for using
  36. Sealink under EMSI (SLK).
  37.  
  38.     options  value              meaning
  39.  
  40.       7       Y                Allow the use of MODEM7 filename exchanging.
  41.       7       N                Don't do anything relating to MODEM7 at all.
  42.  
  43.       P.S. Technically MODEM7 should not be used in DietIFNA, but some sites
  44.            seem to require it.
  45.        
  46.       C       Y                Allow MODEM7 to be skipped on inbound if the
  47.                                remote polls with a 'c'.
  48.       C       N                Do modem7 anyways.
  49.  
  50.       O       T                Only ever generate a Telink header block
  51.       O       S                Only ever generate a SeaLink header block
  52.       O       B                Generate both types of header.
  53.  
  54.       I       T                Accept only Telink header block
  55.       I       S                Accept only SeaLink header block
  56.       I       B                Accept both types of header.
  57.  
  58.       P       Y                Pickup files on outdial.
  59.       P       N                Don't pickup on outdial.
  60.  
  61.       S       Y                Allow the use of FTS7 (SeaLink)
  62.       S       F                Do FTS7 even if not asked for.
  63.       S       N                Don't do FTS7 at all
  64.  
  65.       B       Y                Allow special 'Big Filename' headers to be 
  66.                                  generated
  67.       B       N                Do not generate 'Big filename' headers.
  68.  
  69.       A       Y                Ask for SeaLink by using block/compliment in
  70.                                ACK/NAK's
  71.       A       N                Use only single character ack/nak.
  72.  
  73.       N       Y                Ask for MDM7 by polling with NAK rather than
  74.                                a 'c'.
  75.       N       N                Poll with a 'c'.
  76.  
  77.       W       Y                Wait for Sealink block/compliment on ACK/NAK's
  78.                                NOTE: This will interact VERY badly with Modem7
  79.                                filename transfers, so only use in Sealink
  80.                                transfers.
  81.       W       N                Assume 1 character Xmodem ack/nak
  82.  
  83.       F       Y                Give the first file a header (Telink/SeaLink)
  84.       F       N                Don't give the first file a header.
  85.  
  86.       M       Y                First file is Mail bundle (FTS-1)
  87.       M       N                First file is actual outbound file transfer.
  88.  
  89.  
  90.   example (The current Defaults):
  91.    XprSetup xprfts.library "7y,cy,ob,ib,py,sy,bn,ay,nn,wn,fy,my"
  92.  
  93.   Any option not given an explicit value will get the current defaults.  The
  94.   defaults are set up to be as 'friendly' as possible to as many sites.
  95.  
  96.  
  97. wpl concerns:
  98.     XprSetup  does  not  read any variables, so we use the WXI functions to
  99. obtain   the  sending  program  name  ($(host.mailer)  and  the  Link  rate
  100. ($(Baud)).   All  calculations  are based upon the actual link rate and not
  101. the  locked  rate.   The  mailer  name  is  inserted into the Sealink heade
  102. sending  program  fieldr.   If  this  wpl  varibae was not set, "XPRslk" is
  103. inserted instead.
  104.  
  105.    XprSetup makes an XPR library ready for a transfer.  The first parameter
  106. given  is the xpr library name, and the second parameter is a string passed
  107. to  the xpr library with XProtocolSetup().  The variable $(XprSetup) is set
  108. to  the  numeric  return  of  XProtocolSetup().   A  value of 0 indicates a
  109. failure, otherwise the setup was successful.
  110.  
  111.    Return Values in $(Setup) are or'ed from the following:
  112.  
  113.         XPRS_FAILURE    0x00000000L 
  114.         XPRS_SUCCESS    0x00000001L
  115.         XPRS_NORECREQ   0x00000002L
  116.         XPRS_NOSNDREQ   0x00000004L
  117.         XPRS_HOSTMON    0x00000008L
  118.         XPRS_USERMON    0x00000010L
  119.         XPRS_HOSTNOWAIT 0x00000020L
  120.         XPRS_NOUPDATE   0x00008000L
  121.         XPRS_XPR2001    0x00010000L *
  122.         XPRS_DOUBLE     0x00020000L *
  123.  
  124.     *  Note:  private jammail versions of wpl.library require both returned
  125. to  enable  dual-status  display.  This is WRONG.  Only XPRS_XPR2001 should
  126. trigger  use  of  dual-status  display.   Therefore support for dual-status
  127. display,  while  in  the sources are disabled via a compile define for this
  128. release.
  129.  
  130.